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SECTION 1 


INTRODUCTION 


The use of an assembly program has become a standard practice in 
the programming of digital computers. This type of processor permits a program- 
mer to code in a more convenient language than the 36-bit binary numbers which 
are of significance to a PDP-6; the processor translates the programmer's source 
language to machine code. The advantages of this are widely recognized: 

Easily recognized mnemonic codes are used instead of numeric codes; instructions 
or data may be referred to by a symbolic name without knowing or even caring 
about the actual machine address; decimal or alphabetic data may be expressed 
in a more convenient form than in a binary number; programs may be altered 
without extensive changes in the source language; and debugging is considerably 
simplified. 

MACR06 is an advanced type of assembly processor with a facility 
for using macro-instructions (where long sequences of code may be replaced by 
relatively short statements). It offers all the flexibility permitted by numeric 
coding with all of the above advantages, and in addition permits the assembly of 
relocatable programs. 

The MACR06 system consists of two parts: the source language in 
which programs are coded, and a computer program to translate this source lan- 
guage into PDP-6 code. This document describes the language and some of the 
details of the operation of the processor program. 

The processor program is a two pass assembler in which the source 
language statements are processed twice, once to establish symbol definitions, 
and once to assemble PDP-6 code using these definitions. 

The MACR06 processor, like other parts of the PDP-6 Modular Soft- 
ware System is designed to reflect the modularity of the PDP-6 hardware. 
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The processor receives a string of characters as input. The output 
consists of a character string for listing and a string of binary words containing the 
assembled code. The processor interfaces with output and input routines which fetch 
and store these words and character strings. It is essentially immaterial whether the 
media containing the output and input strings are paper tape, punched cards, magnetic 
tape. Microtape, Teletype or a line printer. Core storage may even be used as an 
I/O medium on the larger configurations. 

The processor produces relocatable binary code. This, too, is inde- 
pendent of the storage medium, in logical blocks containing information to be stored 
in memory by the linking loader. The assembled code format is completely compatible 
with all parts of the Modular Software System, including DDT-6, Checkpoint 6, the 
stack monitor and the time-sharing monitor. 
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SECTION 2 


LANGUAGE FUNDAMENTALS 

THE STATEMENT 

The fundamenfal unit of the MACR06 assembly language is the 
statement. A MACR06 statement is a string of characters; it may be used to 
generate PDP-6 code, data, or to control the operation of the MACR06 processor. 

A statement may be delimited by a semicolon or by a carriage return or the end 
of a card, depending on the input medium. 

Each statement may be numbered. If the first character of a state- 
ment is a digit, all of the following characters up to the first blank are considered 
to be part of the statement number. 

A statement is subdivided into fields which identify the data 
generated by the statement, specify the type of statement, describe the specific 
function of the statement, and comment the statement. 

If a statement is ended with fewer fields than are normally required, 
the unspecified fields are considered null . If a statement has more fields than are 
required, the superfluous fields are taken to be comments. The information between 
the semicolon and the end of card or carriage return is also taken as a comment. 

Label Field - This is a single symbol referring to the memory 

location where the next data word or instruction 
would normally be placed. This field is always 
delimited by a colon. 

Code Field - This field consists of a single word. It describes 

the type of statement and is a mnemonic representing 
a PDP-6 instruction, a type of data configuration or 
a processor control code. It is delimited by either a 
space or a comma. 
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Variable Fields - The function of these fields is determined by the code 

field. They may describe data, machine addresses, 
accumulators, processor control, index registers, etc. 
They may be delimited by commas, parentheses or 

angle-brackets, d epending on their function in th e 

statement . 

Fields consist of elements, codes, expressions and macros. Elements 
are single "words" and represent numeric values; codes are also single words and 
describe statement functions; expressions represent numeric values and are strings 
of elements separated by combinatory operators. Macros are single words and stand 
for character strings. The following are elements: 

A 

TAX 

6 

4.3 E-6 

"TEXT" 

These expressions are combinations of the above elements: 

TAX+6 

"TEXT" &6 

A/4.3E-6+TAX 

The following are codes: 

HLLE 

DATAO 

XWD 


Character Sets 


Punched Paper Tape 

The ASCII character set (Appendix IV) is used to construct statements. 
Two characters may not be used: the reverse slash (\) and the left arrow — ). 
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(They are ignored by the processor). All carriage returns must be followed by a line 
feed, and all line feeds must be preceded by either a carriage return or another line 
feed. Spaces are used to delimit the code field, and may be freely used in other 
places for formatting; tabs are logically equivalent to spaces, and are properly 
translated to spaces on output listings. 

Punched Cards 

A modified Hollerith code (Appendix IV) is used for constructing 
statements on punched cards. As with paper tape, the reverse slash (\) may not 
be used. Only the first 72 columns are considered by the processor; the remaining 
8 may be used for identifying information. Spaces may be freely used for formatting; 
there is no particular usage of card columns for this purpose. To skip lines, blank 
cards are inserted; these generate no information. 
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THE LOCATION COUNTER 


In general, statements generate 36 bit binary words, which are 
placed Into consecutive memory locations. The location counter is a register 
used by the MACR06 processor to keep track of the next available location in 
memory. It is updated after processing each statement. A statement which gen- 
erates a single machine Instruction would update the location counter by 1; a 
statement which generates 6 data words would update it by 6. The location 
counter may be explicitly set by the LOC or RELOC codes. 

ELEMENTS 

36 

Elements represent binary integers less than 2 . There are 

five types of elements: symbols, numbers, characters, points and literals. 

Symbols - These are strings of letters and numbers, the 

first of which must be a letter. Although a 
symbol may be any length, only the first 6 
characters are considered and any additional 
characters are ignored; symbols which are 
identical in their first six characters are consid- 
ered identical. A decimal point may appear in 
the character string of a symbol but may not be 
the first character. 

|- Example: 
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Numbers - 


A number is a string of digits. If the string con- 
tains a decimal point, it is evaluated as a floating 
decimal number and the digits are taken radix \ 0 . 

If the string does not contain a decimal point, the 
digits are assigned values according to the prevail- 
ing radix. (This prevailing radix is normally regu- 
lated by the RADIX code) . If 8 were the prevailing 
radix the number 17 would have the value I70=I5 |q. 

If \0 were prevailing, 17 would have the value 
l7|Q=2lg. The number \ 7 .0 would always have 
the value 2)2(5420)2^0)21)3)210 since the decimal point 
denotes a floating decimal number. A number must 
always begin with a digit or a decimal point. 

Occasionally it may be desirable to change 
the value of the radix for only one numeric element. 
This is done by the qualifier followed by a letter. 
Numbers are qualified in this manner to be Decimal, 
Obtal, or Binary 

Thus : - ■ - 

tD17 = 17,0 

T017 = 15,0 

tBl010 = 10,0 = \2g, 


irrespective of the prevailing radix. These qualifiers 
have no further effect on the prevailing radix. Float- 
ing decimal numbers never consider qualifiers; any 
qualifier is ignored. The exponent parts of floating 
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Point - 


Character - 


decimal numbers may be further argumented by 
following the number by E±n, whereupon the 
number is then considered to be multiplied by 
]0±n. 


P Exam pie: 


1 . 

10.0E- 1 
0.000iE4 

.001E+3 (ALL = 201400000000) 
IE 10 


A number may also be logically shifted left by following 
it by Br. The number is then shifted left so that the 
right hand (low order) bit is in position r (decimal) of 
the 36 bit computer word. 


-Th us : — — I — I - 

03B35 = 000000000003 
03B31 = 00000000060 
03B17 = 000003000000 

The decimal point alone has a special meaning. It 
represents the current value of the location counter. 


.Example: " 

A: JUMP .+6 

, EQUIVALENT TO 
A: JUMP A+6 


If the first non -blank character of an element is a 
quote (")/ the characters following it are assembled 
as their 6 bit ASCII representations: This element is 
terminated by a quote, if more than 6 characters are 
included within the quotes^ only the right hand 6 are 
considered . 
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Literal - 


• Example: ' 

"AXE" is equivalent to 417045 
(This representation is useful with 
immediate mode operations). 

This type of element consists of any statement which 
will generate one word of machine code or data, 
surrounded by a pair of brackets. The appearance 
of a literal causes a cell containing the information 
generated by the enclosed statement to be reserved, 
usually at the end of the program. The element 
represents the address of this reserved cell . Literals 
may be nested to any reasonable depth . 


- Examples: ■■ ■ i — ■■■ ■ n . — 

ADD 2> CDEC 652 * DECIMAL LITERAL 
FAD 1, C8.143, FLOATING POINT 

MOVE 3 , CASCII .BYTES. 3 
XCTCXCTCXCTCADD 2, XT 3 ( 4 ) 3 , N ESTF.D 


pThe last example generates the following constants: 

LITIJ XCT HT2(4) 

LIT2: XCT LlT3 

L1T3: ADD 2>X 
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EXPRESSIONS 


Expressions are strings of elements separated by arithmetic or 

35 

Boolean operators. Expressions represent numeric values less than 2 In 
magnitude. The value of an expression is calculated by first substituting 
the numeric values for each of the elements and then performing the opera- 
tions. The allowable operations are: 

Operator Meaning 

* - multiply 

/ - divide 

+ - add 

subtract 

& - and 

t • t • 

I - inclusive or 

When combining elements, the Boolean operations (and, ior) 
are performed first, from left to right. Then the multiplications are per- 
formed from left to right, and finally the additions end subtractions are 
performed. Division always truncates the fraction part. All arithmetic 
is performed modulo 2^^ = 34, 359, 738^ 368. 

For example, suppose the element 
A represents the value 2^^ 

B represents the value 8^^ 

C represents the value 3^^ 

D represents the value the expression: 

A/B + A*C represents 6^^ 

B/A - 2*A-1 represents -1 = 777777777777g 

A&B represents 0 
B+0]0^q+C represents 21 
1 + A&C represents 3^^ 
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EVALUATION OF SYMBOLS 


The value represented by a symbol is assigned by one of three 

mechanisms: 

(1) Label - If a statement begins with a symbol followed by 
a colon, the symbol is called a label. It is assigned the 
current value of the location counter. 

(2) Direct Assignment - If a symbol appears on the left 
hand side of the = in a direct assignment statement, it is 
assigned a value equal to that value represented by the 
expression on the right hand side. A direct assignment 
statement has the form: 

SYM = EXP, COMMENT 

where SYM is a symbol and EXP is an expression: 

■ Example: — — ' ' ■ — 

A = B+2 

TSIZE = TEND-TSTART 
K = 4 

(3) Variable - If a symbol is followed by a storage 
cell is automatically reserved, (usually at the end of 
the program), and the symbol represents the location 
of this storage cell . 

This is useful for defining a symbolic temporary storage 
location, for example: TEMP^, which reserves a cell 
whose address is represented by TEMP. 

If a value is assigned directly, it may be altered by 

another direct assignment statement. If it is defined as a label or variable, 
it may not be altered. 
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SECTION 3 


STATEMEN TS 


The meaning of a statement is determined by the code field. The 
code is a mnemonic word representing a machine operation, a data configuration, 
or a processor control code. Every statement must have a code. The code field 
is delimited by either a space, a comma, or a statement delimiter. 

Although codes are similar in appearance to symbols, they should 
not be confused. For example, ADD may be either a symbol or a code; in con- 
text, however, it is unambiguous. 


COMMENT STATEMENTS 

A statement with a blank code is considered to be a comment. 
(Obviously this code must be delimited by a comma). 

> Example: — - . 

, THIS IS A COMMENT 

INSTRUCTIONS 


When the code field contains the mnemonic of a machine instruc- 


tion concatenated with a mode mnemonic, a statement represents a machine in- 
struction. There are two types of instructions - primary and I/O. Two state- 


ments are: 


read: DATAI PTR> §NUM(4) 
SUM: ADD 2, TABLE (X3) 


The first field of an instruction statement is a label . The single symbol 
in this field is given a value equal to the memory address occupied by the instruction 
The next field is delimited by a space and is the code. If the next field is delimited 
by a comma, it is the accumulator in a primary instruction or the device number in 
an I/O instruction; otherwise it is an expression for the address referenced by the 
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instruction. If there is an accumulator field, then the following field is the 
address. The last field, enclosed by parentheses, is an expression representing the 
index register. The (§> appearing in the address field indicates an indirect address. 


The accumulator or device field may be left out, and the code 
delimited by the comma or a space. In this case the accumulator or device number 
is considered to be zero. If indexing is not used the index field may also be left 
out, and the address field delimited by a comma, carriage return or semicolon. 

A blank address field is considered to be zero. The following instruction state- 
ments are proper. 

JRST .+3; 

ADD 2,X 

JUMP (4) 

CONO 203 , ENABLE PC ON CH 3 


Assembly 


Instructions are assembled in the following manner: Each instruction 
code represents a 36 bit number. If it is a primary instruction code, the low order 
4 bits of the value of the accumulator expression are ior'd into positions 9-12. 

The low order 9 bits of the value of the device expression of an I/O instruction 
are ior'd into positions 3-11 . The low order 18 bits of the value of the address 
expression are ior'd into the right half of the instruction. If the indirect address 
symbol# appears in the address field, a bit is placed into position 13. Finally, 
if the index register field exists, the lower 4 bits are ior'd into positions 14-17. 


Numeric Codes 

Numeric codes are considered to indicate primary instructions. The 
remainder of the statement is assembled as a normal instruction. If the numeric code 
is preceded by a minus sign, the twos complement of the number is taken; the minus 
sign is ignored for other codes. Character elements are considered to be numeric. 


13 




|i~ Example: 


THE VALUE OF A IS IN THE RT HALF 
270B8 2,Xi EQUIVALENT TO ADD 2,X 
TD65i 000000000101 IS GENERATED 
-li 777777771777 IS GENERATED 


EXTENDED INSTRUCTIONS 

For programming convenience/ some extended codes have been 
devised. These represent a machine instruction combined with an accumulator 
or device number. 

JEN = JRST/ - Jump and enable the PI system 
HALT = JRST 4/ - Halt, then Jump 
JRSTF = JRST 2/ - Jump and reset flags 
JOV = JFCL 8/ - Jump on over flow and clear 

JCRY0 = JFCL 4/ - Jump on CRY0 and clear 

JCRYl = JFCL 2/ - Jump on CRY 1 and clear 

JCRY = JFCL 6/ - Jump on CRYl or CRY0 and clear 

JPC = JFCL 1/ - Jump on PC change and clear 

RSY^ = DATA I 0f - Read the switches 
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DATA GENERATING CODES 


Several codes are used to indicate various types of data configurations. 

These codes describe the type of data to be generated. A label on a data generating 

statement refers to the first word assembled. 

DEC - Decimal data - set the radix to ]0 for this 

statement only and generate a word for each 
expression following the code. Expressions 
are separated by commas. 

- Example; — 

DEC 10, 4.5, 3.1416, 6.03E-26, 3i 
5 WORDS GENERATED 

OCT - Octal data - similar to the DEC code, but the radix is 

temporarily set to 8 

» Example: » " " ■ '■ ■ ■ - 

OCT -3, 2, 777, 4.1; THE 4TH ITEM IS FLOATING PT. 

EXP - Expressions - The radix is unchanged. Each expression 

following the code generates one 36 bit data word. 

- Example; ■ ■ — 

EXP X, 4, t065, HALF, B+362-A; 

XWD - Transfer word - Two expressions follow this code which 

generates one data word. The low order 18 bits of the value 
of the first are placed in the left half word, and the low 
order 18 bits of the value of the second expression are placed 
into the right half. 

r Example: ■ — — i..-— — — i-,-,- i.-,,. — 

ATOB: XWD A,B; TRANSFER FROM AREA A TO B 
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z- 


lOWD - 


POINT - 


Zero word - One word containing zeros is generated. 

Examplet^n- 

TEMP: Z, TEMPORARY STORAGE 

I/O transfer word used in the BLKI and BLKO instruc- 
tions. Two expressions separated by commas follow 
this code which generates one data word. The left 
half of the assembled word contains the twos comple- 
ment of the value of the first expression, and the right 
half contains the value of the second expression minus 
one . 

Example: ■ ■ - .. - 

INAREA: lOWD 6> tD865i 

ASSEMBLES AS 777778000377 

Byte Pointer Word. The first expression indicates the 

byte size, the second indicates the address, and the 

third indicates the position of the right hand bit of the 

byte position. The indirect character^), and an index 

expression in parentheses may appear in conjunction with 

the address part. The local radix for the position and 

size expressions is always lj2l, regardless of the prevailing 

radix. 

Example: ' ■ ' ■■ ■ ■ ■ - ■ 

STRING: POINT 6>@N(4),5, 

,POINTS TO THE LH CHAR 

If the position expression is left blank, the position part 

will assemble as 44g. On incrementing, the pointer will 

point to the left hand byte . 
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SIXBIT 


Alphabetic Information. This code is used to generate characters 
in 6 bit ASCII code, pack them into 6 character words and place 
the words in sequential registers . The first non blank character 
following the code is the delimiter. Information is assembled 
from the second character until the first character is repeated. 
Only the printing characters of the ASCII code are assembled, 
except that line feeds are assembled as 74 (\) . 

Example — . 

NUMBR2 SIXBIT ”2” 

ALPHA: SIXBIT /ALPHABETIC INFORMATION/ 

,EQUI\/ALENT TO 

ALPHA; OCT 41 14605041 A2, 45645 1 4300 5 1 t 
OCT 564657625541, 6451575600001 


ASCII- Alphabetic information. This code is similar to SIXBIT, but it 

packs words with the low seven bits of the full ASCII represen- 
tation . All of the ASCII characters may be assembled under 
this code, and the normal injunction against the reverse slash 
( \ ) and back arrow ) is relaxed. 

-Example: - ■ ■ 

ASCII . 

..A CARRIAGE RETURN AND LINE FEED 

BLOCK - Block of storage reserved. - The expression following the 

code indicates the number of cells to be reserved. The 
location counter is incremented by the value of the ex- 
pression . 

r Example : " ■ . " ■— — 

MATRIX; BLOCK N*M 
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BYTE - 


Byte strings. The first expression following this code is 
enclosed in parentheses and is the byte size. Subsequent 
expressions, separated by commas, are evaluated, truncated 
to the byte size, packed and assembled into sequential 
memory locations. If a byte cannot fit into a word, it is 
assembled as the first byte of the next word . The byte 
size may be altered in the middle of a word or a string by 
inserting a byte size expression in parentheses. The local 
radix for the size portion is always considered to bel|2l, 
no matter what value the prevailing radix may have. 


- Example ; ■ 

RADIX 10 

AX: BYTE (6) 10, 4, 9, 1, 1, 3, 6 

Q: byte (15) 12, 3, 9, 

STR: byte C6) 10, 4, 9 (12) "AB" 

, EQUIVALENT TO 

AX: OCT 120411010103, 060000000000 

Q: OCT 000400000300, 000110000000 

STR: OCT 1204110041425 
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PROCESSOR CONTROL CODES 


These statements do not generate data or instructions, but control the 
operation of the processor. 

REPEAT - This code causes a character string to be repeatedly 

processed . The code is followed by an expression 
whose value indicates the number of repetitions 
desired. This is followed by the string to be re- 
processed enclosed by ang I e -brackets . 


— Example: - - ■ — 

ADDX; REPEAT 3<ADD 6,X(4) 

AUDI 4, 1> 

, EQUIVALENT TO 
ADDX: ADD 6^X(4) 

ADDI 4, 1 
ADD 6,X(4) 

ADDI 4, 1 
ADD 6,X(4) 

ADDI 4, 1 
SQ: REPEAT N < 

EXP » + . + SQ* SQ+ 1 - 2* . *SQ+2* • -2*SQ> 

A TABLE OF SQUARES 

The label of a repeat is placed on the first statement generated. 


REPEATS may be nested to any reasonable degree’. 


'REPFAi iM+1 

<M0VF; 6> A(K) 

REPEAT N 

<ADD 6y (3) 


ADDI 3>L> 


MOVEM 6,A(K) > 


IFn - Conditional assembly - An IFn code is followed by an 

expression, and a string of coding enclosed in angle- 
brackets. If the expression fulfills the condition indicated 
by n, the string is processed; if not it is ignored. The IFn 
codes are: 
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IFE Assemble if expression is zero 

IFG Assemble if expression is posiHve 

IFGE Assemble if expression is positive or zero 

IFL Assemble if expression is negative 

IFLE Assemble if expression is negative or zero 

IFN Assemble if expression is non zero 

IF! Assemble if PASS 1 (no expression) 

IF2 Assemble if PASS 2 (no expression) 

rExample:— 

IFZ X-Y <ADD XJ> 
^ASSEMBLED ONLY IF X=Y . 


Conditional assembly on character strings. 

This is followed by three sets of angle-brackets. 
If the character strings enclosed by the first 
two sets of angle -brackets are identical, the 
coding within the third set is processed. 

■►Example: — — 

IFIDN <-f> < + > <FAD 3>X> 

>FAD 3,XS WILL BE PROCESSED 


Conditional assembly on character strings. 

This is the converse of IFIDN and is similar in 
format. The coding within the third set of angle- 
brackets is processed if the two character strings 
differ. 

Tbe prevailing value of the radix is controlled by 
this code. It is followed by a decimal number 
between 2 and 10 which then becomes the pre- 



vailing radix. The radix may be changed at 
any point on the assembly; it is initially con- 
sidered to be 8 . 

- Example:’ ■ ■ - 

RADIX 10, 

,SET PREVAILING RADIX DECIMAL 

LOC - This code changes the location counter to a 

value equivalent to the following expression. 
The block of coding following a LOC is as- 
sembled into the absolute locations, and any 
labels defined are considered absolute. 

-Example;- ■ — ■ 

ADD AC2,X 
LOC 200 
ADD AC3,§Q2 

LOC .+3, SKIP 3 LOCATIONS 
ADD AC1,AC2 


RELOC - This is similar to LOC in that it explicitly sets the 

location counter. The block of code which follows 
is relocatable tand all labels within the block are 
relocatable. The Implicit statement: 

RELOC 0i 

Degins all programs. 

PHASE - A portion of code may be moved into other registers 

before it is executed. PHASE gives the location 
counter a value different from the location into 
which the assembled code is to be loaded. The 
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code is actually loaded into continuing sequential 
locations, but all labels within a PHASE'd area are 
in relation to the PHASE. Point elements (.) also 
relate to the PHASE. PHASE is followed by an 
expression indicating the first address of the sub- 
routine when it Is to be executed . 



MOVE [XWD LOOPX, LOOP] 

BLT LOOP+5 

LOOPX: 

# 

PHASE 11 

LOOP: 

Z 

MOVN ACX) 

FMP MPYR 

FADM A(Y) 

SOJGE X> .-3 

JRST ©LOOP 

DEPHASE 


This example is the central loop in a matrix inversion. 
Before executing it, the routine will be moved into 
fast accumulator memory locations 11 - 16. The symbol 
LOOP represents 11 and the point in the SOJGE in- 
struction represents 15. The routine is, however, loaded 
Into the normal sequential registers. A phased area is 
terminated by a DEPHASE, LOC or RELOC code. The 
DEPHASE code has no effect on the next sequential 
loading location, but restores the location counter to 
this value . 
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PASS 2 - 

END - 


NOSYM - 


ERRORS - 


LIT - 


VAR - 


RIM - 


This code causes the location assignment phase, PASS 1 
to be suspended and PASS2 to commence . 

This statement is the last statement in a program or subroutine. 
If it is a program, then the following expression is the location 
of the first instruction to be executed. 

The assembler will normally output a symbol table or list of 
the symbols used and their definitions. The code NOSYM will 
suppress this. 

The first couple of assemblies usually turn up a number of 
errors. This op-code will suppress all output except those 
items with errors, allowing convenient correction without 
unnecessary output. 

This code will cause literals that have been previously defined 
to be assembled starting at the current location. If n literals 
have been defined, the next free cell will be at (.+n). This 
statement will have no effect on literals which are defined 
after it. LIT may not be used more than eight times. 

This code will cause the symbols which have been defined 
by following them with (^) in previous statements to be 
assembled at this place as block statements. This has no 
effect on subsequent symbol definitions of this type. This, 
and the previous pseudo-op, LIT, are useful in controlling 
storage allocation. If these codes do not appear, all 
variables and literals are placed at the end of the program. 

In paper tape assemblies, this code will cause binary output 
to be punched in RIM format. 
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OPDEF - 


Define an operation mnemonic. This is followed by 
a symbol and a pair of brackets containing a state- 
ment that will generate one word of data. The symbol 
then becomes a mnemonic for the operation code repre- 
sented by the 36 bit data word. 



These opdefs may then be treated as ordinary op codes: 



SYN - Define synonyms. This code is followed by 2 symbols 

or macros. The first must have been previously defined, 
and the second is made equivalent to it. If the first is a 
symbol, the second becomes a symbol with the same 
value; if the first is a macro, the second becomes a 
macro which acts identically; if the first is a machine-op, 
control code or data generating code, the second will 
behave in the same manner. 



If the first item is identical to both a symbol and a code, 
the second item (which is the synonym) is made synonymous 
with the symbol in preference to the code. 
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Listing Conirol 


Several codes are used to control the final listing. 


LIST - 

XL 1ST - 
LALL - 

XALL - 
TITLE - 
SUBTTL - 

PAGE - 


Causes the processor to begin listing the assembled program, 
in both octal and source text. 

Causes the processor to stop listing the assembled program. 
Causes the processor to list all text that is processed: macro 
expansions, list control codes, repeats, etc. 

Causes the processor to stop listing all text. 

The comments field is written at the top of each printed page. 
The comments field is written as a second line at the top of 
each printed page and the listing skips to the next page. 

The listing begins a new page. (A form feed on the input tape 
also has this effect). 


These list control codes are never printed in the final listings, except under LALL. 
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SECTION 4 


RELOCATION AND LINKING 

RELOCATION 

The MACR06 assembler will create a relocqtable program. This pro- 
gram may be loaded into any part of memory and will presumably function properly. 

To accomplish this the address field of some instructions must have a relocation constant 
added to it. This relocation constant is equal to the difference between the memory 
location an instruction is actually loaded into, and the location it is assembled into. 

Most programs begin in location 6^0-; if a program is loaded into cells beginning at 

O 

location 14 j0j0q, the relocation constant, K, would be 13^o. 

o o 

Obviously, not all instructions must be modified by the relocation 

constant. Consider the two instructions: 

MOVE I 2, .-3 

MOVE I 2, 1 

The first is probably used in address manipulation and must be modified; 
the second probably should not. To properly accomplish the relocation, the actual 
expression forming an address is considered and modification is decided on this basis. 
Integer elements are "fixed" and not modified. Point elements are "relocatable" and 
are always modified.* Symbolic elements may be fixed or relocatable according to the 
means used in their definition. If a symbol is defined by direct assignment statement 
it may be relocatable or fixed depending on the expression following the =. If a symbol 
is defined as a macro, it is replaced by the string and the string itself must be considered. 
If it is defined as a label or a variable (^), it is relocatable.* Finally, references to 
literals are relocatable.* 

To evaluate the relocatability of an expression, consider what happens 
at loading time. A constant, K, must be added to each relocatable element, and the 
resulting expression evaluated. 

* Except under the LOC code which specifies absolute addressing. 
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-Example;- - - ■ -i- ■ 

A, B, C & D are relocatabi e 

X = A + 2*B -3*C + D 

k is the relocatability constant. 

X = (A +k) + 2* (B+k) -3* (C + k) + (D + k) 

X’’ = A + 2*B -3*C+D+k 
r 

Thus, the expression X, under relocation, is relocatable. 
Some conventions are followed concerning relocatability: 

1) Only 2 values of relocatability for a complete 
expression are allowed, k and 0. 

2) An element may not be divided by a relocatable 
element . 

3) Two relocatable elements may not be multiplied 
together. 

4) Relocatable elements may not be combined by 
Boolean expressions. 

If any of these rules are broken, the relocatability of 
the resulting expression is considered to be 0, and 
the assembled code is flagged. 

If a, c and b are relocatable symbols, then: 

is relocatable 
is fixed 
is relocatable 
is relocatable 
is erroneous 


(a+b-c) 

(a-c) 

(a+2) 

(2*a) 

{2#a-h) 
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LINKING SUBROUTINES 


Programs usually consist of subroutines which must be linked. This 
is relatively easy if all of the subroutines are assembled together; they can be 
linked by means of JSR^ SUBR instructions. If independently assembled, relocatable 
subroutines are used, linking them must be considered, since the symbol tables from 
the assembly are inaccessible to the loader. 

To accomplish this linking, selected symbols are made available to 
the Linking Loader by the codes EXTERN and INTERN . 

The EXTERN code identifies certain symbols as external to the program. 
The condensed object program contains the information that values for certain symbols 
must be derived from other programs at load time. An expression containing a 
reference to an external symbol must consist of only the single external symbol . 

The statement: 

EXTERN SORT, CUBE, TYPE; 

identifies the symbols SQRT, CUBE and TYPE as external symbols. Symbols defined 
as external must not be defined as labels, variables, macros or assignments. 

To make internal program symbols available to other subroutines as 
external symbols, the code INTERN is used. This code has no effect on the actual 
assembly of the subroutine, but will merely make a list of symbol equivalences 
available to other programs at loading time. The statement 

INTERN SIN, COS, SIND, COSDi 

might appear in a sin-cos routine where SIN, COS, SIND and COSD were entry 
points to the subroutine to calculate respectively sines and cosines of angles in 
radians and degrees. Internal symbols must be defined within the subroutine as 
assignments, labels or variables. 
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For example, if a square roof is required, it would be called by 



Some subroutines will have fairly common usage, and it will become 
convenient to place them in a library. To load these subroutines, the code 
LIBRARY is used. If the SQRT routine mentioned above were a library program, 
the statement: 

LIBRARY SQRT; 

would also appear in the program. The code LIBRARY is followed by a list of 
programs (expressed as 6 character identifying codes) required from the library. 

~ LIBRARY KS 401, SQRT, ANFSQ2; 

would cause the programs numbered KS401 , SQRT and ANFSQ2 to be loaded from 
the library. Library routines each have their own internal symbols, and EXTERN 
statements are also necessary. 
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SECTION 5 


MACRO INSTRUCTION 


When writing a program, it is often desirable to abbreviate certain 
commonly used coding sequences. Consider the following example of coding which 
computes the length of a vector with components stored in 3 sequential locations: 


i-Aampie: 


MOVE 0,V; 

FMP 0; 

MOVE 1,V&1 
FMP M 
FAD 1; 

MOVE l,V&2 
FMP Ul 
FAD 1; 

JSR FSQRT; 
MOVEM LENGTH; 


GET THE FIRST COMPONENT 
SQUARE IT 


ADD IN THE SQUARE OF THE SECOND 


ADD IN THE SQUARE OF THE THIRD 
USE THE FLOATING SQUARE ROOT ROUTINE 
STORE THE LENGTH 


A simpler method of coding would be to use a 
subroutine call: 


JSP SJ,VLENGTH 
EXP V, LENGTH 


A macro instruction may be defined which will generate either of the 
above coding sequences with one statement : 


VMAG VECT, LENGTH 
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This statement consists of a macro-name, followed by the arguments, 
in this case the location of the first component and the location of the memory cell in 
which to store the result. To be able to generate the above subroutine call with one 
statement, the programmer must define the macro VMAG. This is done by use of the 
DEFINE code. 


DEFINE VMAG (A,B) 
<JSP SJ, VLENGTH 
EXP A,B> 


This macro definition statement consists of the code DEFINE, followed 
by the name of the macro, a pair of parentheses containing a dummy string of arguments, 
and a pair of angle-brackets containing the coding to be generated each time the 
macro is called. A comment may appear between the parentheses and angle-brackets. 

The string of dummy arguments is merely used as a model, and these may 
be any symbols that are convenient - usually single letters will do. The angle-brackets 
may contain any proper string of coding, normally, but are not restricted to a group of 
complete statements. 

When the macro is called, real arguments are substituted for the dummy 
arguments in the definition. The coding in the angle-brackets is reproduced, except 
that each appearance of a dummy argument is replaced by the corresponding actual 
argument in the calling statement. In the example cited above, A and B are the dummy 
arguments in the definition. The calling statement has the real arguments VECT and 
LENGTH. The coding actually generated by the call is: 

JSP SJ, VLENGTH 
EXP VECT, length 


The real arguments may be enclosed with parentheses or the parentheses 
may be omitted. If parentheses are used, the argument string is ended by a closed 
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parenthesis; if they are omitted, the argument string ends when all the arguments 
of the definition are filled, or when a carriage return, closed bracket, or semi- 
colon delimits an argument. When parentheses are used (this is implied by an 
open parenthesis following the macro name), all superfluous arguments are 
ignored. The above call for the vector length subroutine may have been written 
with equal validity as: 

VMAG (VECT, LENGTH) 

Arguments must be separated by commas. If an argument contains 
a comma, it must be enclosed by a pair of ang I e -brackets . These angle -brackets 
act only as argument delimiters and are stripped off in the actual argument. An 
example of this is: 



DEFINE JEQ (A,B,C) 
<MOVE (A) 

CAMN B 

JRST C> 

he program jumps to C. 

)D 2,X} then the macro 

If fhe data in Location B is equal to A, then t 
If the contents of B must be compared to the instruction AC 

call would be written: 


JEQ <ADD 2,X>, B, INSTX 

Angle -brackets surrounding the ADD 2,X are removed and the 

proper coding will be generated. 

A macro need not have arguments. The instruction: 


DATAO PTP,PUNBUF(4) 


which causes the contents of PUNBUF, indexed by register 4 to be output to the 
paper tape punch, may be generated by the macro PUNCH, defined by: 


DEFINE PUNCH 

<DATAO PTP, PUNBUF(4)> 
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This macro would be coded as: 


PUNCH THE ANSWER | 

"THE ANSWER" becomes a comment when the macro is replaced by 
the defined pseudo code. 


A macro need not be used in the statement code field. The string 
within the angle-brackets of the definition exactly replaces the macro name and 
its argument string. The macro: 


DEFINE L (A ,B) <3*B-3*A+3> 


cells are used to 


gives an expression for the number of items in a table where 3 
store each item. A is the address of the first item and B is the address of the last 
item. To load an index register with the table length, one might write: 


MOVE X,L(FIRST,LAST) 


CREATED SYMBOLS 

When a macro is called, it is often convenient to generate symbols, 
without explicitly stating them in the call. Created symbols accomplish this. 

Each time a macro that requires a created symbol is called, a symbol is generated 
and inserted in the macro. These generated symbols are of the form . .nnnn; that 
is, two decimal points followed by four digits. The first created symbol that is 
generated is . , the next . .j2ij0J02, etc. 

If a symbol in a definition statement is preceded by a %, it is con- 
sidered to be a created symbol . When a macro is called, all missing arguments that 
are of the form %X are replaced by created symbols, if they are so specified. 

The following macro will cause the textual information "A" to be written 
out on the console, followed by a halt and a jump to B. The additional label is 
necessary since the text statement generates an indefinite number of data words. A 
created symbol is appropriate here since the programmer is probably not interested 
in the label . 


DEFI 

NE TYPE (A, XB) 

<JSR 

TYPE 

HALT 

%B 

SIXBIT /’AV 

1 %B:> 
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This macro is called by: 


TYPE HELLO 


The cal I: 

TYPE HELLO, BX 

will not generate a created symbol. Instead, the explicit symbol overrides the 
created symbol . 


CONCATENATION 

The above example also illustrates the use of the concatenation 
operator, the apostrophe. An argument may not necessarily refer to a complete 
symbol but refers to a string of characters. The apostrophe may not be used other- 
wise within a macro definition, and further it is not a meaningful operator outside 
of a macro-definition. Another example is the macro: 

DEFINE J(A,B,C) 

<JUMP’A B,C> 

The generated code when the macro is called by: 

J LE,E,X&1 

is: 

JUMPLE 3,X&1 
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INDEFINITE REPEAT 


Often in the definition of a macro, it is not known in advance how 
many arguments there will be. An example Is a macro used to set up a symbol table. 
This table consists of a word of code corresponding to a 6 character symbol, 
followed by a word of temporary storage. There may be an indefinite number of 
symbols in the table. This is easily Implemented by on indefinite repeat: 

DEFINE STABLE(A) 

<IRP (A) 

<SIXBIT /’AV 
Z» 

The IRP A ^EXP^ indicates that A is composed of a string of sub- 
arguments separated by commas, and that the expression enclosed by angle- 
brackets is to be repeated with each sub-argument inserted in turn. 

The above macro when called by; 



Macro definitions may appear within other definitions to any reasonable 
depth. A macro within another macro is not defined until the outer macro 
is called. The macro -processor simply substitutes the arguments into the defined 
string of characters, and nesting is wholly consistent with this type of operation. 
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If a macro name which has been previously defined appears wifhin 
another definition statement, the macro is redefined, and the original definition 
is exorcised . 


The first example, calculation of the length of a vector, may be used 
to illustrate this: 


DEFINE VMAG (A,B,%C) 
<JSP SJ,VL 
EXP A,B 
JRST %C 

VLS MOVE 2,(SJ) 

MOVE (2) 

FMP 0 

MOVE 1,1(2) 

FMP 1,1 
FAD 1 

MOVE 1,2(2) 

FMP 1,1 
FAD 1 
JSR FSQRT 
MOVEM @1(SJ) 

JRST 2(SJ) 

7.C: 

DEFINE VMAG (A,B) 
<JSP SJ,VL 
EXP A,B>>. 
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This macro VMAG is defined as an entry to a closed subroutine followed 
by the closed subroutine. The nested redefinition redefines the macro as only the 
entry. The first time the macro is called, the subroutine is generated. Subsequent 
calls generate only the calling sequence - there is no need for another subroutine 

io be generated. 

Another use of redefinition is a subroutine handler. On entering a 
subroutine, k accumulators are stored, and the prevailing radix is altered to one 
local to the subroutine. On exiting, the accumulators and radix are restored. 


DEFINE EXIT <> 

DEFINE F.NTER ( R, K> %A, %B, XC, %E) 

< %B : Z 

%A=10, SACE THE OLD RADIX 

RADIX R 

REPEAT K <MO\/EM .-%B+1> %C+.-%B+l> SAVE ACS 
SYN EXIT, %Di SAVE DEFINITION 
DEFINE EXIT NEW DEFINITION 
<%E: RADIX %A, RESTORE OLD RADIX 

REPEAT K <M0VE .-%E, C+.-%E> RESTORE ACS 
SYN %D, exit; RESTORE DEFINITION 
PURGE %A,%DI REMOVE JUNK FROM TABLE 
JRST@%B, RETURN FROM SUBROUTINE 
%C: BLOCK K, AC STORAGE> > 


Each time ENTER is called, EXIT is redefined. To use this macro to store 
4 accumulators on entering a subroutine and setting the local radix to 10, the following 
would be written: 


SUBR; ENTER (10,4) 
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ADDITIONAL CODES 


CRSYM - 


This code is analogous to VAR and LIT. It Is a processor 
control code and indicates that previously undefined 
created symbols are to be given values according to the 
present contents of the location counter. Each undefined 
created symbol increments the location counter by 1 . 
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SECTION 6 


ERRORS 

Occasionaiiy, even the best of us commit small errors in writing 
programs. There are two classes of errors — errors in language usage and program 
errors. MACR06 will examine the statements for this first class of error, and 
print appropriate messages. These errors are caused by meaningless or inconsistent 
constructs in the source language. When a listing is prepared during the assembly, 
each MACR06 statement that contains errors will be flagged by one or several 
letters in the margin. At the end of the listing will be a summary of the errors; 
this summary will be printed even if a listing is not prepared. Program errors 
which properly use the MACR06 language will be correctly translated into errors 
in the binary program. 


THE ERROR FLAGS 

M Multiply defined symbol - a symbol is defined more 
than once, either as a label or variable. 

The symbol retains its original definition. 

S Symbol Error - There is a meaningless character string 
that resembles a symbol or macro. It is assembled as 
though the value were zero. 

P Phase Error - A symbol is assigned a value as a label 
during pass 2 different from that which it was assigned 
in pass 1 . An error of this type will terminate an 
assembly; it would probably indicate an error in 
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o 

N 

A 

L 

F 

U 

V 

R 


condifional assembly or in macro redefinition and 
therefore propagate throughout the entire program. 
(Symbols re-assigned by "=" will not cause phase 
errors) . 

Undefined Code - The code indicating the state- 
ment type is not defined in the code table. It is 
assembled as a numeric code of zero. 

Number Error - There is a meaningless string of 
characters that resembles a number. It is assembled 
as zero . 

Argument Error - An argument of a control code has 
a peculiar value. 

Literal - There is an error within a literal . 

Macro Definition Error - A format error exists in a 
DE FINE statement. 

Undefined Symbol - A symbol or macro is undefined . 
it is given a value of zero. 

Value Previously Undefined - A symbol used to control 
the processor is undefined prior to the point at which 
it is first used . 

Relocation Error - An expression has a relocation constant 
other than 1 or 0 , contains division by a relocatable 
number, contains the product of two relocatable numbers, 
or involves relocatable numbers in Boolean operations. 
The relocation constant is set to zero. 
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D Multiply Defined Symbol Reference - The statement 

contains a reference to a multiply defined symbol . 

It Is assembled with the first value defined. 

An error message in the summary will have the following format: 


LOG 

A + N 

MACRO (n) 

E 

(Location 

(Symbolic 

(Macro called 

(Error 

Counter) 

Address) 

depth) 

flags) 
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SECTION 7 


ASSEMBLY OUTPUT 

ASSEMBLY LISTING 

There are two types of assembly output, the assembly listing and the 
binary program. The assembly listing consists of a printoutof the source program. 
On the same line with each source statement are 3 numeric fields: the location of 
the assembled code, the left halfword, and the right halfword. Above each line 
containing an error is an appropriate message. This listing is controlled by the 
List Control Codes except that error messages are always printed. All assemblies 
begin with an implicit LIST. 


BINARY PROGRAM 

The binary program may assume two forms; RIM and LINK. The RIM 
(Read-in Mode) format is always punched into paper tape and is used for such things 
as loaders and computer hardware maintenance programs. RIM programs may be 
completely loaded by the loader resident in the shadow memory located "behind*' 
the accumulator memory. 


Rim Format 

Programs in RIM mode consist of two word pairs. The first word is an 

instruction: 

DATAI PTR, A, 

The second word of the pair is the word of instruction or data to be 
loaded into memory location "A". 

The last word of a RIM tape is a single instruction: 

HALT, START; 

where START is the first location of the program. 
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Link Format 


LINK format is the normal binary output mode. Programs in this format 
are acceptable to the Linking Loader, and are generally relocatable. The Linking 
Loader will load sub-programs into memory, properly relocating each one and ad- 
justing addresses to compensate for the relocation. It will also link External and 
Internal symbols to provide communication between independently assembled sub- 
programs. Finally, the Linking Loader will call and load library sub-routines. 

LINK format data is in blocks. All blocks have an identical format. 

The first word of a LINK block consists of two halves. The left half is a code for 
the block type, and the right half is a count of the number of data words in the 
block. The data words are grouped in sub-blocks of 18 items. Each 18 word sub-block 
is preceded by a relocation word. This relocation word consists of 18 two bit bytes. 

Each byte corresponds to one word in the sub-block, and contains relocation information 
regarding that word. 

If the byte value is: 0 - no relocate occurs 

1 - the right half is relocated 

2 - the left half is relocated 

3 - both halves are relocated 

These relocation words are not included in the count; they always appear 
before each sub-block of 18 words or less to insure proper relocation. 

This block format is universal. All programs (except those in paper tape 
RIM format) are stored in this format, including programs on paper tape. Microtape, 
standard magnetic tape, punched cards, drums and discs. This format is totally 
independent of logical divisions in the input medium (40 word check summed paper tape 
blocks, 128 word blocks on Microtape and drums, 23 word check summed punched 
cards, etc). It is also independent of the block type. 
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Code 1 - 


Code 2 - 


Code 3 - 


Code 4 - 


Code 5 - 


The Formats for the Block Types 
Program and Data (assembler and compiler output) 

Data word 1 - The location of the first word in the block 
Data words 2-N - Up to N-1 words of program or data 
to be loaded. 

Program symbol table (local symbols) 

The data words are in pairs, the first is the symbol (In 

6 bit ASCII) and the second is the value. This block is 

necessary for debugging routines. 

Internal/external symbol table 

The data words are in pairs. 

Data word 1 - symbol (6 bit ASCII) 

Data word 2 (LH) - 1 for a right hand external 

2 for a left hand external 
4 for an internal 

(RH) - symbol value for internal 

link for external 

These symbols are used to link independently assembled 
subroutines. The second and subsequent occurrence of 
an internal symbol is ignored. 

Library requests. 

Each data word is the name (6 bit ASCII) of a library 
routine to be loaded . 

Highest relocatable point. 

This is the last block in a subroutine. It contains 1 word, 
which is the location of the highest memory address used by the 
relocatable program. Upon loading, the relocation constant 
(initially set to zero) is replaced by this number to properly 
relocate the next subprogram . 
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Code 6 - Name 


Code 7 


Code 10 


There is 1 data word with the subroutine name. This usually 
is the first block. 

- Starting address 

There is 1 data word with the starting address of the program. 
This block should only occur in conjunction with the main pro- 
gram. The second and subsequent occurrences of this block are 
ignored . 

- Combined interna I -externa I 

The data words are split into a right half and a left half. The 
right half is the link, and the left half the value. These items 
are used to control forward references in one pass compilers. 
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SECTION 8 


PROCESSOR INITIALIZATION 


At the beginning of each assembly the assembler is initialized to certain 
states, generally affected by control codes. The initial states are: 

1 . Radix is set to 8. 

2. The location counter is set to zero and relocatable assembly 
will occur. 

3. There will be a normal listing. 

4. There will be LINK binary output with a symbol table. 

5. Phase mode is off. 

6. The title and subtitle are blanked. 

7. Only device mnemonics are placed in the symbol table. They are: 


APR 


Arithmetic Processor 

PI 

= 0A 

Priority Interrupt System 

PTP 

= 140 

Paper Tape Punch 

PTR 

= 144 

Paper Tape Reader 

CP 

= 114 

Card Punch 

CR 

= 114 

Card Reader 

TTY 

= 1?0 

Console Teleprinter 

LP 

= 124 

Line Printer 

DIS 

= 134 

Display 

DC 

= ?04 

Data Control 

UTC 

= 214 

Micro Tape Control 

UTS 

= 214 

Micro Tape Status 

MTC 

= 224 

Mag Tape Control 

MTS 

= 224 

Mag Tape Status 

MTM 

= 234 

Mag Tape Status 

DCSA 

= 344 

Data Communication System 

DCSB 

= 344 

Data Communication System 


8. No Macros or Opdefs exist. 
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APPENDIX I 


CODES 


Dafa Generating 

Codes 

DEC - 

Decimal Numbers 

OCT - 

Octal Numbers 

EXP - 

Expressions 

XWD - 

Block Transfer Word 

lOWD - 

Input/Output Transfer Word 

POINT - 

Pointer Word 

SIXBIT - 

ASCII (6 bit) character strings 

BYTE - 

Variable length bytes 

BLOCK 
ASCII - 

- Block of storage reserved 
ASCII (7 bit) character strings 

Processor Control Codes 

REPEAT - 

Repeat character string 


IFn - Conditional Assembly 

n Condition 

E zero 

G positive 

GE zero or positive 

L negative 

LE zero or negative 

N non zero 

B blank 

1 pass 1 

2 pass 2 


OPDEF - 

Define an op mnemonic 

SYM - 

Define a synonym 

PHASE - 

Enter Phase mode 

DEPHASE - 

Leave Phase mode 
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RIM - Assemble RIM tapes 

IFIDN - Conditional Assembly on character strings 

IFDIF - Conditional Assembly on character strings 

RADIX - Radix control 

LOC - Set Location Counter 

PASS2 - Terminate Pass 1 

NOSYM - Suppress Symbol Table Output 

LIT - Assemble Literals 

VAR - Assemble Variables 


CRSYM - Assemble Created Symbols 
EXTERN - List of External Symbols 
INTERN - List of Internal Symbols 
LIBRAR - List of Library Subroutines 
IRP - Indefinite Repeat 

PURGE - Purge Symbols 
END - Last Line 


List Control 


LIST - List 

XLIST - Stop Listing 

LMAC - List Macro Expansions 

XMAC - Stop Listing Macro Expansions 

TITLE - Title 

SUBTTL - Subtitle 

PAGE - Skip to top of next page 

ERRORS - Suppress Output except for error messages 
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APPENDIX II 


A - 
D - 
F - 
L - 
M - 
N - 
O - 
P - 
R - 
S - 
U - 
V - 


SUMMARY OF ERROR FLAGS 

Argument of Control Op 

Reference to multiply defined symbol 

Macro Definition 

Useage of Literal 

Multiply defined symbol 

Number 

Undefined Operation Code 
Phase Discrepancy 
Relocation 
Symbol 

Undefined Symbol 
Value previously undefined 
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APPENDIX III 


TITLE 


BEGIN: 


, RUN 

GO: 

RUN: 


DELMAX 

TMAX: 


PROGRAMMING EXAMPLE 


BUG6 


THIS IS A GAME IN WHICH A SMALL CIRCLE RUNS AROUND THE 
FACE OF THE SCOPE. IT STARTS RUNNING AT A HIGH SPEED 
AND EVENTUALLY SLOWS DOWN, STOPPING ON ONE OF THE 12 
CLOCK POSITIONS. MOMENTARILY FLIPPING DATA SWITCH 35 
UP WILL RESTART THE BUG AND IT WILL REPEAT THE CYCLE, 
STOPPING ON A NEW POSITION. RANDOM NUMBER GENERATOR 
IS USED TO DETERMINE THE AMOUNT OF TIME THE BUG WILL 
DWELL AT ANY POSITION. THIS RANDOM NUMBER IS INITIA- 
LIZED FROM THE SWITCHES. 


HALT .+1; STOP TO SET THE DATA SWITCHES 

, INITIALIZE THE FOUR CELLS OF THE 
,RANDOM NUMBER GENERATOR TO 0, A 
, NUMBER READ FROM THE SWITCHES, ANOTHER 
,0, AND A CONSTANT. 

RSW R2 

CLEARS R1,R3 

MOVE R4,[ 12345670123] 

MOVEI CLOCK, 0; START AT TWELVE OCLOCK 
JSR SCOPE; START THE SCOPE RUNNING 


THE SPOT AROUND THE SCOPE 
CLEARM TIMER; 

JSR RAND; 

ANDI DELTAT, DELMAX; 
ADD TIMER, DELTAT; 
MOVE WAIT, TIMER; 


SOJN WAIT,.; 

MOVE POSITIONCCLOCK) 
MOVEM TABLE+1 
SOJGE CLOCK,. +2; 
MOVEI CLOCK, tDll; 

TDNN TIMER, TMAX; 
JRST RUN; 

RSW TIMER; 

TRNN TIMER, 1; 

JRST .-2; 

JRST GO; 

=7777, 

777700000000, 


FIRST ZERO THE ACCUMULATING 

TIMER, GET A RANDOM NUMBER 
LIMIT THE RANDOM NUMBER 
ADD IT TO THE ACCUMULATING 
TIMER, MOVE THE TOTAL TO A 
, COUNTER 

COUNT DOWN TO KILL TIME 

ADVANCE CLOCK TO NEXT POSIT. 

HAVE WE PASSED TWELVE OCLOCK 
RESET CLOCK BACK TO ONE 

ARE WE READY TO STOP IT 
NO 

YES, BUT INSTEAD OF ACTUALLY 
HALTING, IT LOOPS UNTIL DS35 
IS SET. THIS ALLOWS THE 
DISPLAY TO CONTINUE 
MAXIMUM TIME INCREMENT 
MAXIMUM TOTAL TIME 
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,RANDOM 


RAND: 


NUMBER GENERATOR 

THIS RANDOM NUMBER GENERATOR ADDS FOUR RANDOM NUMBERS 
MODULO 2t35 TO GET A FIFTH RANDOM NUMBER. THEN IT 
REPLACES THE FIRST BY THE SECOND, THE SECOND BY THE 
THIRD, THE THIRD BY THE FOURTH, AND THE FOURTH BY THE 
FIFTH TO RESET THE GENERATOR. THE FOURTH IS THE GENE 
RATED RANDOM NUMBER. 

Z 

MOVE DELTAT,R1; 

ADD DELTAT,R2 
ADD DELTAT,R3 
ADD DELTAT,R4 

MOVE Rl,R2j 
MOVE R2,R3 
MOVE R3,R4 
MOVE R4,DELTAT 

JRST @RAND 


ADD FOUR RANDOM NUMBERS 


REPLACE VALUES 
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, DISPLAY ROUTINE 
SCOPE: Z 

CONO PI, 10400; 
EXCH TBLPTl; 
WOVEN TBLPTR#; 
EXCH TBLPTl; 
CONO DIS,112; 


DATAO DIS, TABLE; 

CONO PI, 2340; 

JRST ©SCOPE; 

,DI SPLAY MACROS 

DEFINE INCREMENT (A ,B ,C,D,E,F,G ,H,I 
A WORD OF SCOPE INCREMENTS 
<BYTE C2)A(4)B,C,D,E(2)A{4)F,G,H,I> 

,SOME DEFINITIONS TO USE IN THE INCREMENT MACRO 

RADIX2 

DISPLAY THE POINTS (INTENSIFY 
EXCAPE FROM THE MODE 
INCREMENT: PLUS X 

PLUS X AND PLUS Y 
PLUS Y 

MINUS X AND PLUS Y 
MINUS X 

MINUS X AND MINUS Y 
MINUS Y 

PLUS X AND MINUS Y 

RADIX8 

DEFINE XYPOS CA,B) A WORD TO POSITION THE DISPLAY 
AND THEN START THE INCREMENT MODE 

<BYTE (2)0(3)1 ,1 (10)A(2)1(3)6,1(10)B;> 


1 = 1 , 

ESCAPE=10, 
PX=1000, 
PXPY=1010, 
PY=0010, 
MXPY=1110, 
MX = 1 100, 
MXMY = 111 1 , 
MY = 0011 , 
PXMY=1011, 


SHUT DOWN THE PI SYSTEM 
INITALIZE THE TABLE POINTER 
WITHOUT DISTURBING AC0 

START THE DISPLAY ASSIGNING 
, SPECIAL CHANNEL 1 AND DATA 
, CHANNEL 2 

GIVE THE SCOPE ITS FIRST 
,WORD 

TURN ON THE PI SYSTEM, ACT- 
,1 VATING CHANNELS 1 AND 2. 
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, DISPLAY TABLE 

TBLPTl: lOWD 0, TABLE; INITIAL 10 WORD FOR SCOPE 

, TABLE 

TABLE; BYTE ( 1 8) (5) 1 C4)<3) 1 (2)2 ( 1 ) 1 (3) 5; START IN XY 

, TRACE A CIRCLE IN THE INCREMENT MODE 

XYPOS 1000,1600; MODE 

INCREMENT I ,PX,PX,PXPY,PX,PXPY,PX,PXPY,PXPY 
INCREMENT I ,PY ,PXPY ,PY ,PXPY ,PY ,PY ,PY ,PY 
INCREMENT I ,MXPY,PY,MXPY,PY,MXPY,MXPY,MX,MXPY 
INCREMENT I ,MX,MXPY,MX,MX,MX,MX,MXMY,MX 
INCREMENT I ,MXMY,MX,MXMY,MXMY,MY,MXMY,MY,MXMY 
INCREMENT I ,MY ,MY ,MY ,MY ,PXMY,MY ,PXMY,MY 
INCREMENT I ,PXMY,PXMY ,PX,PXMY,PX,PXMY,PX,PX 


BYTE (1)1 (17) (7) (1)1 (1)1; EXCAPE FROM INCREMENT MODE 

,AND STOP 


, CLOCK POSITIONS 

POSITION; XYPOS 1000,1600; TWELVE 

XYPOS 500,1520; ELEVEN 

XYPOS 260,1300; TEN 

XYPOS 200,1000; NINE 

XYPOS 260,500; EIGHT 

XYPOS 500,260; SEVEN 

XYPOS 1000,200; SIX 

XYPOS 1300,260; FIVE 

XYPOS 1520,500; FOUR 

XYPOS 1600,1000; THREE 

XYPOS 1520,1300; TWO 

XYPOS 1300,1520; ONE 


OCLOCK 


,INTERRUPT TRAPS 


LOC 42 

JSR SCOPE; CHANNEL ONE FOR SCOPE STOP 
Z 

BLKO DIS,TBLPTR; CHANNEL TWO FOR DATA INTEi 


,ACCUMULATOR ASSIGNMENTS 

RUT 

R2 = 6 

R3 = 5 

R4 = 4 

DELTAT=3 
TIMER =2 
CL0CK=1 


END BEGIN 
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APPENDIX IV 


CHARACTER SETS 



ASCII 

6 bit 
ASCII 

Punched 

Card 


ASCII 

6 bit 
ASCII 

Punched 

Card 

( space ) 

240 

00 

b 

300 

40 

4-8 

1 

241 

01 

12-7-8 

A 

301 

41 

12-1 

11 

242 

02 

0-5-8 

B 

302 

42 

12-2 

# 

243 

03 

0-6-8 

C 

303 

43 

12-3 

$ 

244 

04 

11-3-8 

D 

304 

44 

12-4 

% 

245 

05 

0-7-8 

E 

305 

45 

12-5 

& 

246 

06 

11-7-8 

F 

306 

46 

12-6 

1 

247 

07 

6-8 

G 

307 

47 

12-7 

( 

250 

10 

0-4-8 

H 

310 

50 

12-8 

) 

251 

11 

12-4-8 

1 

311 

51 

12-9 

* 

252 

12 

1 1-4-8 

J 

312 

52 

11-1 

+ 

253 

13 

12 

K 

313 

53 

11-2 

/ 

254 

14 

0-3-8 

L 

314 

54 

11-3 


255 

15 

11 

M 

315 

55 

11-4 

• 

256 

16 

12-3-8 

N 

316 

56 

11-5 

/ 

257 

17 

0-1 

O 

317 

57 

11-6 

0 

260 

20 

0 

P 

320 

60 

11-7 

1 

261 

21 

1 

Q 

321 

61 

11-8 

2 

262 

22 

2 

R 

322 

62 

11-9 

3 

263 

23 

3 

S 

323 

63 

0-2 

4 

264 

24 

4 

T 

324 

64 

0-3 

5 

265 

25 

5 

U 

325 

65 

0-4 

6 

266 

26 

6 

V 

326 

66 

0-5 

7 

267 

27 

7 

W 

327 

67 

0-6 

8 

270 

30 

8 

X 

330 

70 

0-7 

9 

271 

31 

9 

Y 

331 

71 

0-8 


272 

32 

11-0 

Z 

332 

72 

0-9 

) 

273 

33 

0-2-8 

c 

333 

73 

11-5-8 

< 

274 

34 

12-6-8 

\ 

334 

74 

7-8 

= 

275 

35 

3-8 

3 

335 

75 

12-5-8 

> 

276 

36 

11-6-8 

1 

336 

76 

5-8 


277 

37 

12-0 


337 

77 

7-9 
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